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BACKGROUND OF THE INVENTION 

AppUcation programs, such as web pages, are typically deployed on a server 
connected to an information network, such as the well-known World Wide Web. The 
applications are accessible by users at faciUties that are remote from the site of the server 
that executes the application programs. This implementation has important benefits such 
as reducing computer memory and processing requirements at the remote cUent, and 
increasing the security of the application by retaining selected portions of the application 
in a secure location in the Web server. 

One disadvantage of implementing the application remotely from the end user is 
that the person responsible for debugging problems with the application program(s) is 
also typically located at a site that is remote from the location of the server. 

One approach that is currently available allows complete access to servers from 
remote locations. Many customers are uncomfortable with this approach due to the 
potential for unauthorized access to the information contained on the server. Complete 
access to the servers also poses a risk of disrupting operation of the server, whether 
malicious or unintentional. The alternative with this approach is for a consultant to travel 
to the site of the server to debug problems with the application programs, which is both 
more time consuming and costly than desired. 

Therefore, there is a requirement for the capability to access and debug 
application programs from a location that is remote from the site of the server that 
executes the application program(s). The capability should not allow unauthorized access 
to other information stored on the server where the application program being debugged 
resides. The capability should also not allow disrupting the server's operation. 
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SUMMARY OF THE INVENTION 

In one embodiment, a method of debugging an application program from a 
workstation that is remote from a server on which the appUcation program resides is 
provided. The method includes: 
5 invoking the application program from the workstation via a network interface; 

displaying a user frame at the workstation that includes information generated by 

the application program; 
providing a debug view option at the workstation for generating a debug frame of 
the application program; and 
10 displaying the debug frame at the workstation when the debug view option 

P is selected. 

J 5 In one aspect of this embodiment, the debug frame includes information aboxit one 

M or more components of the apphcation program. 

is In another aspect of this embodiment, the user is provided with a user view option 

Cj 15 at the workstation for generating the user frame. The user frame is displayed at the 
^ workstation when the user view option is selected. 

In another aspect of this embodiment, the debug frame at the workstation displays 
a list of variable names in the application program. When used in a Java programming 
language environment, the debug frame can include a list of request information variable 
20 names and/or session information variable names in the application program. 

In another aspect of this embodiment, one or more of the variable names 
represents a corresponding object. When the user selects one of the variable names, the 
debug frame displays information about the object corresponding to the variable name. 
The information about the object can include the fields of the object, the methods 
25 associated with the object, and/or the constructors associated with the object. 

In another embodiment, a method of debugging an application program from a 
workstation that is remote from a server on which the application program resides is 
provided. The method includes: 
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executing the application program on the server when the apphcation program is 

invoked from the workstation; 
generating information for a user frame at the workstation that includes 

information generated by the application program; and 
5 generating information for a debug frame at the workstation when a debug view 

option is selected from the workstation, wherein the debug frame includes 

information about components of the application program. 

hi one aspect, this embodiment includes generating information for the debug 
frame includes saving the information for the user frame when the debug view option is 
10 selected. The saved information can be restored and displayed on the user frame when a 
user view option is selected at the workstation. 

hi another aspect, this embodiment includes generating a list of components of the 
application program which can include a list of variables in the application program, a list 
of methods associated with one or more of the variables in the application program, 
15 and/or a list of constructors associated with one or more of the variables in the application 
program. These lists of components can be generated using reflection technology 
conventionally available in known computer programming environments. 

The methods in accordance with the present invention can be embodied in the 
form of computer-implemented processes and apparatuses for practicing those processes. 

20 The methods can also be embodied in the form of computer program code embodied in 
tangible media, such as floppy diskettes, CD-ROMS, hard drives, or any other computer- 
readable storage medium where, when the computer program code is loaded into and 
executed by a computer, the computer becomes an apparatus for practicing the invention. 
The method can also be embodied in the form of computer program code, for example, 

25 whether stored in a storage medium, loaded into and/or executed by a computer, or 
transmitted over some transmission medium, such as over electrical wiring or cabling, 
through fiber optics, or via electromagnetic radiation, wherein, when the computer 
program code is loaded into and executed by a computer, the computer becomes an 
apparatus for practicing the invention. When implemented on a general-purpose 
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microprocessor, the computer program code segments configure the microprocessor to 
create specific logic circuits. 

The various embodiments of the present invention for remotely debugging an 
appUcation program can be implemented for use in a variety of programming language 
5 environments. For example, the remote workstation can include a web browser for 
viewing web pages that are generated by a Java application program on a remote server, 
and transmitted to the workstation via a network interface. If there is a problem with the 
appHcation program, a developer can invoke the debug fi-ame to investigate the status of 
various components in the appHcation program, such as the value of one or more 

10 variables. The developer can also view information related to each of the variables, such 
as the fields, methods, and constructors associated with the variables. The developer can 
view internal, public, and private code associated with the program without 
compromising the security of other application programs on the server. This ability to 
remotely debug application programs in accordance with the present invention is thus 

15 more time and cost efficient than previous methods, and also alleviates concerns about 
security and unauthorized access to the server. 

The above as well as additional objectives, features, and advantages of 
embodiments of the present invention will become apparent in the following detailed 
written description. 

20 BRIEF DESCRIPTION OF THE DRAWINGS 

The present invention may be better understood, and its numerous objects, 
features, and advantages made apparent to those skilled in the art by referencing the 
accompanying drawings. 

Fig. 1 is a diagram showing a network environment with a remote user. 

25 Fig. 2 is a diagram showing fiirther details of an example of the workstation 

in Fig. 1 . 



-4- 



Docket No. M-n705 US 
Client Ref. No. T00053 
773394 vl 



Fig. 3 is a diagram showing further detail of the network environment of Fig. 1 in 
accordance with the present invention. 

Fig. 4a is an example of a user frame generated by an application program. 

Fig. 4b is an example of a debug frame generated by a debugger program in 
5 accordance with the present invention. 

Figs. 4c and 4d show further information that can be displayed for a variable 
selected by a user in the debug frame in Fig. 4b. 

Q Fig. 5 is a flowchart of a method for storing and restoring variables of the user 

|f frame of Fig. 4a and generating information for the variables that can be displayed on the 

Cj 10 debug frames in Figs. 4b-4d. 

f?j; The use of the same reference symbols in different drawings indicates similar or 

identical items, 

2 DESCRIPTION OF THE PREFERRED EMBODIMENT(S) 

pi In at least one embodiment, the present invention provides capability to debug an 

15 application program without allowing access to other information on a server, or 
disrupting the server's operation. A debugger program in accordance with the present 
invention allows access to information pertaining to the application program being 
debugged, but does not allow the information to be changed. Liformation regarding the 
environment in which the application program is running can be displayed, such as the 
20 computational resources required by the application program, and the vendor and version 
of compilers and other programs that are used in connection with the application program. 
The source of problems for an application program can also be investigated at a site that 
is remote from the server on which the application program is running. 

An example of one type of problem that can be investigated with a debugger 
25 program in accordance with the present invention is the generic "null pointer" message 
that is commonly displayed for a malfunctioning web page. 
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Referring now to Fig. 1, an information network 110, such as the Litemet, is 
shown in Fig. 1. A user that wishes to access information on the Internet typically has a 
client workstation 112 capable of estabUshing a communication link with 
servers 1 14, 1 16, 1 18 through network interface 122. Various communications links may 
5 be utilized, such as a dial-up wired connection with a modem, a direct link such as a Tl, 
ISDN, or cable line, a wireless connection through a cellular or satellite network, or a 
local data transport system such as Ethernet or token ring over a local area network. 
Accordingly, network interface 122 includes networking equipment that is suitable to 
support the communication link being utilized. In addition, workstation 200 may be one 
10 of many workstations connected to other types of networks such as a local area network 
(LAN), a wide area network (WAN), or other information network through network 
interface 122. 

Workstation 112 typically includes a user interface to allow the user to enter 
commands and/or information including requests to search for documents pertaining to a 

15 specified topic, to send or receive electronic mail, to interact with an electronic commerce 
site, and/or to provide data input. One such user interface is a web browser, such as 
Internet Explorer, which is commercially available from Microsoft Corporation in 
Redmond, Washington. The user interface uses various standardized interface protocols 
for accessing information from servers 114, 116, 118. For example, hypertext transfer 

20 protocol (HTTP) and HTTP secure (HTTPS) are used to access web pages, simple mail 
transfer protocol (SMTP), Internet message access protocol (IMAP), and post office 
protocol (POP) which are used to access electronic mail, and domain name system 
(DNS), dynamic host configuration protocol (DHCP), and lightweight directory access 
protocol (LDAP) which are used to access directories and other databases. Application 

25 programs are included in servers 114, 116, and 118 to perform tasks requested by the 
user. 

Fig. 2 shows a block diagram of components comprising client workstation 112, 
One or more central processing units (CPU) 202 are connected by host bus 204 to main 
memory 206, storage device controller 208, network interface 210, and input/output (I/O) 
30 devices 212 connected via I/O controllers 214. Those skilled in the art will appreciate 
that workstation 112 can be embodied in a variety of computer systems including, for 
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example, desktop, notebook, laptop, palmtop, and other devices that include information 
processing, storage, and networking components. In one embodiment, workstation 112 
also includes cache memory 220 to facilitate quicker access between CPU 202 and main 
memory 206. In another embodiment, workstation 112 may include components such as 
5 audio and video controllers 216 and I/O peripheral devices such as speaker system 218, 
graphics device 222, and other I/O devices 212 such as display monitors, keyboards, 
mouse-type input devices, voice recognition devices, electronic pen devices, floppy and 
hard disk drives, DVD drives, and CD-ROM drives. In some embodiments, the 
peripheral devices communicate with CPU 202 over one or more buses 204, 226, 228, 
10 communicating with each other through one or more bridges, such as host-to-PCI 
bridge 230, and PCI-to-ISA bridge 232. 

One skilled in the art will recognize that the foregoing components and devices 
^ are used as examples for sake of conceptual clarity and that various configuration 

M modifications are common. Consequently, as used herein the specific exemplars set forth 

^15 in Fig. 2 are intended to be representative of their more general classes. In general, use of 
L specific example herein is also intended to be representative of its class and the non- 

%| inclusion of such specific devices in the foregoing hst should not be taken as indicating 

}Z that limitation is desired. 

^ Referring again to Fig. 1, application programs in the servers 114, 116, 118 are 

20 accessible by multiple users, yet, the processing and memory requirements at each 
workstation 1 12 are substantially less than that which would be required if the application 
programs were hosted on each workstation 112. However, when application programs 
are placed in the servers 114, 116, 118, they can be quite difficult to debug firom 
workstation 112. 

25 FIG. 3 is a diagram of information network 300 in accordance with the present 

invention that is one example of an implementation of information network 100 (Fig. 1). 
Server 302 is representative of one or more of servers 114, 116, 118 that includes one or 
more application programs 304 with internal code 306 that is unique to application 
program 304. Server 302 can also include private code 308 that can only be accessed by 

30 authorized application programs 304 through the use of a password or other security 
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mechanism. Public code 310 can also reside on server 302 for use by any application 
programs 304 that require it. Internal code 306, private code 308, and public code 310 
can comprise data, logical instructions, and/or markup language files such as hypertext 
markup language (HTML) or extended markup language (XML) pages. 

5 Server 302 also includes a debugger program 312 that can be used to troubleshoot 

problems from one or more remote client workstations 112. In the implementation shown 
in Fig. 3, web browser 314 provides a user interface to access application programs 304 
and debugger program 312 via network interface 122. The debugger program 312 
preferably has access to private code 308 and any other data associated with application 
10 programs 304. This includes Java server pages (JSP) request/session parameters and 
public variables for objects. 

An example of when debugger 312 can be used is when a user, running web 
browser 314 on the workstation 112, enters the imiversal resource locator (URL) to access 
one of the application programs 304 for a web page. After the user enters the URL into 

15 the workstation 112, the web browser 314 contacts the server 302 via the network 
interface 122, the corresponding application program 304 generates the requested web 
page, and the requested web page is transmitted via the network interface 122 to the web 
browser 314. Web browser 314 presents the requested web page to the user. The web 
page can include information from internal code 306, private code 308, and/or public 

20 code 310. 

The web page display can include user interface controls such as selectable icons 
and buttons, scroll bars, data/command input areas, and field entry points. When the 
application program 304 for the requested web page includes an error, however, 
server 302 transmits an error message to the user's workstation 112 indicating that the 
25 application program 304 has failed. Web browser 314 can display the error message to 
the user. 

Referring to Figs. 3, and 4a-4d, Figs. 4a-4d show examples of a graphical user 
interface (GUI) display 400 generated by debugger program 312 in accordance with the 
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present invention. The GUI display 400 includes selectable features, such as tabs 404 
and 406 to provide options to display a user frame 408 or a debugger frame 410, 

The user frame 408 includes information generated by the application 
program 304 being debugged. The debugger frame 410 is mapped to the user frame 408 
5 from the standpoint that the context of the debugger frame 410 is sensitive to the context 
of the user frame 408. For example, Fig. 4a shows a catalog web page for a color monitor 
in user frame 408. Figs. 4b-d show the debugger frame 410 with the various components 
in the application program 304, such as variables, variable values, fields, method calls, 
and constructors, used to generate the catalog web page in user frame 408. A scroll 
10 bar 412 allows the user to view more information than can be displayed on one screen. 

For one of many reasons, user frame 408 may not render correctly. To investigate 
the reasons for the problem, the developer selects the debugger view tab 406, thereby 
causing the web browser 3 14 to link to the debugger program 312. 

The debugger program 312 generates the debug information displayed in the 
15 debugger frame 410, A user can investigate the source of errors in the application 
program 304 that generates the information or error messages on the user frame 408. For 
example, user frame 408 can display the generic message "Null Pointer Exception" 
generated by the application program 304 when one or more variable(s) used by the web 
page has a null value. The debugger frame 410 allows the user to display the types and 
20 values of variables, methods and constructors associated with the variables, as shown in 
Figs 4b-4d. Other components of interest can also be displayed, depending on the type of 
application programming environment being used. 

The ability to determine the cause of an error from the remote workstation 112 
(Fig. 1) is more time and cost efficient than traveling to the site of server 302 to debug 
25 problems with the application programs 304, 

Referring to Figs. 3 and 5, Fig. 5 shows an embodiment of a process for 
generating the debugger frame 410 (Figs. 4b-4d) for an application program 304 (Fig. 3). 
In process 502, the current state of the application program 304 is stored, including a hash 
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table of all the variables identified in the apphcation program 304. In one 
implementation, technology known in the art as Java Server Pages, version 1.0 (JSP 1.0) 
is used to store the current state of the apphcation program 304. This allows the user to 
return to the display on user frame 408. JSP 1.0 generates a Java source file for each 
5 JSP 1.0 file. The JSP processors produce three files for each JSP file including a .Java 
file, which contains the Java language code for the application program, also referred to 
as a servlet; a .class file, which is the compiled servlet; and a .xml file, which keeps track 
of the files generated by the processor. 

Process 504 enables the user to examine components of the application program 
10 304 to determine the source of the problems with the application program 304. In one 
embodiment, technology known in the art as "reflection" is used for this purpose in 
process 504. Reflection technology allows the user to examine variables including their 
type, class, and value. The variables are usually objects that contain fiirther data 
including properties of the object and data that populates the object, 

15 Thus, when executed, the debugger program 312 performs a context save of the 

current web page to enable a return to the user frame 408. In one implementation, the 
debugger program 312 reads the variables in the current web page using Reflection 
technology. The variables are either request parameters (passed back and forth to the user 
via hypertext transfer protocol (HTTP)), or session parameters. The session parameters 

20 are objects on server 302 that are not transmitted to the user. The session parameters 
store data that is used to generate the display, such as an HTML file for a web page. 

The Java Reflection API can be used to introspect the private code 308^ the public 
code 310, and the internal code 306 of an application program 304. The values for the 
objects can be stored in a database or in memory, as indicated by process 504, when a 
25 user invokes the debugger program 312 by selecting the debug view option 406 (Fig. 4a). 
The values for the objects can be restored when the user selects the user view option 404, 
as indicated by process 508. 

Note that the Java programming languge includes the AccessibleObject class 
method setAccessible() which can be used to enable access to all the declared fields that 
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were retrieved with Reflection, including those that are private, protected. Ordinarily, 
Java's rules of access control prevent accessing private code 308. However, the 
AccessibleObject class (the superclass of Field, Method, and Constructor) provides 
setAccessibleO methods that enable trusted code (or semitrusted code with the 
5 ReflectionPermission "suppressAccessChecks") to access private code 308 including 
fields and methods. A user can enable or disable display of data for private code 308. 

Once process 504 completes the hash table for the variables, process 506 displays 
the information in the hash table in debugger frame 410, as shown, for example, in Fig. 
4b. When the user queries one of the variables by selecting it from the display, process 
10 510 generates the debug frame 510 shown in Figs, 4c and 4d that includes the fields, 
values, methods, and constructors for the selected variable. 

The user can select tab 404 to return to the user frame 408 at any time. The 
information that was displayed at the time the user selected tab 406 for the debugger 
frame 410 is restored in process 508. In one implementation, the stored state is retrieved, 
15 the current state is erased, and the retrieved state is restored. 

Note that other suitable programming languages and methods for saving and 
restoring the state of an application program can be used instead of, or in addition to, Java 
and Reflection technology. 

The present invention has been described in the context of a fiiUy fimctional 
20 computer system, however those skilled in the art will appreciate that the present 
invention is capable of being distributed as a program product in a variety of forms, and 
that the present invention applies equally regardless of the particular type of signal 
bearing media used to actually carry out the distribution. Examples of signal bearing 
media include: recordable type media such as floppy disks and CD-ROM, transmission 
25 type media such as digital and analog communications links, as well as media storage and 
distribution systems developed in the ftiture. 

The foregoing detailed description has set forth various embodiments of the 
present invention via the use of block diagrams, flowcharts, and examples. It will be 
understood by those within the art that each block diagram component, flowchart step. 
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and operations and/or components illustrated by the use of examples can be implemented, 
individually and/or collectively, by a wide range of hardware, software, firmware, or any 
combination thereof 

Although the invention has been described with reference to specific 
5 embodiments, this description is not meant to be construed in a limiting sense. Various 
modifications of the disclosed embodiments, as well as alternative embodiments of the 
invention, will become apparent to persons skilled in the art upon reference to the 
description of the invention. For example, various types of application programs residing 
on a remote server, in addition to, or instead of application programs for web pages, can 
10 be debugged from a remote workstation with the debugger program. It is therefore 
contemplated that such modifications can be made without departing firom the spirit or 
scope of the present invention as defined in the appended claims. 



- 12- 



